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1. 2EQDi]£T IDENTTPTrArpTHM 



Product Title: 



Part Number : 
Sales Numbers: 



Edition VII Workbench (Version 
Binary Systems Software Package 

04-164 



2.4) 



S50-316, S51-302, S51-303, 
S52-303, S52-304, S52-305, 
S53-303, S53-304, S53-305 



S52-302, 
S53-302, 



2. AVAILAPLR PACKAGES 



This section discusses the available binary packaqes. 
Each sales number has a suffix which indicates the distribu- 
tion media. Available media are: 



Media 



800 BPI tape 
1600 BPI tape 
16MB MSM disc 
16MB IDC disc 
25MB IDC disc 



Part Number 


Installation 


Suffix 


Type 


B 


tape 


C 


tape 


P 


msm cl3r 


Q 


idc cl3r 


U 


dl9r 



The installation type is used in determining the 
installation procedure to follow. These media are shown as 
an underbar •_• in the tables below. 

The following is a list of the available binary system 
packages for Edition VII Workbench (Version 2.4). Each of 
these packages allows for the specified number of ports 
contains complete documentation, and a single 800 BPI taoe! 
1600 BPI tape, 13MB MSM format cartridge disc, 13MB IDC for- 
mat cartridge disc, or 19MB Lark Cartridge disc as specified 
by the suffix. 

Three types of systems are listed down the left side- 
initial CPU, additional CPU, and educational. The software 
for all of the entries in this table is identical; the onlv 
difference IS in the type of license required. All entries 
in this table have the part number 04-164. 

At the head of the table. Groups I, ii, and III refer 
to processor types. Group I includes the 3205 processor. 
Group II includes the 7/32, 3210, 3220, and 3230, whil4 
Group III includes the 8/32, 3240, 3250, and 3250XP. Edi- 
tion VII does not support the 3200MPS. 
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Ports 



16 ports 
initial CPU 



BINARY SYSTEMS 
Group I Group II Group lil^ 



S51-302-AB_ S52-302-AB_ S53-302-AB. 



llj?":^^ . ^ S51-302-XBI S52-302-XB_ S53-302-XB 
additional CPU - 



32 ports 
initial CPU 



S51-303-AB_ S52-303-AB_ S53-303-AB. 



add??Ional CPU "^-^"-^«- S52-303-XB_ S53-303-XB_ 



64 ports 
initial CPU 



See note 1 S52-304-AB_ S53-304-AB 



^j,??5^^ , See note 1 S52-304-XbJ S53-304-XB 
additional CPU - 



128 ports 
initial CPU 



See note 1 S52-305-AB_ S53-305-AB_ 



addi??onIl CPU '"' '°'' ' S52-.305.XB_ S53.305-XB_ 



16 ports 
educational 



S50-316-AB_ S50-316-AB_ S50-316-AB_ 



a. DQCUMRNTATTON 



The Edition VII workbench (Version 2.4) Binary Systems 

f^fnr^L r?r"-^^^°" Package (Number 04-164P00M99R04) con- 
tains the following manuals: 



contact ^'the'^'"«™v^^4^.?51?.''y^^P«i-l ^"ote only. 
(201)632-3333. 



Contact the UNIX support group at Pine Street 
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DOCUMENTS 
Publication Number Title 



^^"^^2 ^^^-^^2 Edition VII workbench Programmer's 

Reference Manual (Volume 1) 

48-093 FOl R02 Edition VII Workbench Programmer's 

Reference Manual (Volume 2) 

^^'^^^ "The C Programming Language" by 
Brian Kernighan and Dennis Ritchie 



51-043 



"A UNIX Primer- by Ann Nichols Lomuto 
and Nico Lomuto 



A. I NTRQDUC TTO N TQ mSTJ^LLhUm 

rpK^ Edition VII is derived from UNIX* Version 7 software 

of'thrEdulon^'vTT^i' ^^""^r' '^ ^^^° reprinLd in volume 2 
tlue^lI^^llILl^i^^ -der th^ 

Of thfLliowInSf '''" ""^^'^ '"' '"'"'"^ ""'' workbench is one 
* 9-track, 800 BPI magnetic tape 

9-track, 1600 BPI magnetic tape 

CDD 16MB removable disc+, IDC format 

CDD 16MB removable disc+, MSM format 

Lark 25MB IDC disc+, idc format 
whii/^"^''^ installations receive a single tape or disc 



^"mP i® ^ Trademark of Bell Laboratories. 

tfiM«^ "^''^ ""^ ^^='=' ^1^° ""own as a cisR, contains 

16MB unformatted or 13MB formatted capacity Th2 25m 

capacftr '=°"'^^^"^ "MB unformatted or"^ 19mI' fo?matt^ 
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ONIX ""Uern^r^^nr fi!''^h'e''LeTl^^2f "'""^ ^'^^ °f the 
source and manual sections for thl™ P"g"™s, along with 
altogether. The binarv fmL«= ,~ '''°"'= 2300 files 
needed to flesh out th^ file svb^^™ '^°"\ "^^^ °^^^' things 
will run, are to be put in one In/^^^?" so Edition ,vll 
file system- The=I fi^^° ^^^® system called the 'root 

are normlTi; p?Icld In a°f??F ^^^ ^"° " ''l°<=''s, but 
allow for ex^nslon! The secoil ITi.^l?! *T ^^ ''^°^^^ to 
the online manual, and the f?hr,rfii ^^*'*'" '*"^ libraries, 
the Edition VII kernel These ?n!f "^^^^^ary to regenerat^ 
blocks, but are noJ^ally pfaced fn »''?-?^ ^""^ ^^S" ^^ 

blocks to allow for inclGsLn of fo^rcl fnd^ irrlV" °^ "600 
sion. Buurce and further expan- 



^- fiEliUEAL fiIiUQ£LIliES 



trrx P^ '^^^^ three sections describe how tn ine+.=.n =.^.^. 
VII from tape and disc Th*:. ^Tk«*^ Z install Edition 

example installation on "a non-ftandarT ^^T^^""'^^ ^^^ ^^ ^" 
while the third procedure deal «wf?h ^^^^^^^^s 67MB disc, 
19MB fixed disc The ar^Lf^- *^^^^ ^ non-standard address 
the configuration supplied! ^^" "^^"^^ "^^ ^^P^"^^^ on 

All disc packs used by Edition vtt mna*. k ^.^. 
tor^r^friil^S^df!''^-^^^^ '^-' "° ^'^--" tr^%ks^^L^ie^L^ 

your XsLm^ln'Lriri^rir^ ll lilt H TntUitil,ir''ll °' 

t-K^ u'^^t console terminal must be at address xma» 

the highest baud rate and even parity. ^ ' "^^''^ 

In the installation procedures the marhin^ic ^ ^ . 
shown underlined, and exnl an^^^f,, machine's output is 
brackets [] . ' explanatory comments are shown in 



ences 



''to°"Ih'e°"^yS%f'"l^t^'L'\°2pe^'^Sf?<'"" there are refer- 
ences are in the form x(a?brwhere ^ t^^iJ^^^ ''^^^^ "f^"^" 

the drive number, and b is the offset froi^ fi^° l^^^' = " 
pack. ^ orrset from the start of the 



Disc types recognized are: 
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dsk [ lOMB disc, fixed or removable platter ] 

d40 [ 40MB disc ] 

d67 [ 67MB disc ] 

d256 [ 256MB disc ] 

cl3r [ odd 13MB removable cartridge ] 

cl3f [ odd 13MB fixed ] 

c40f [ cdd 40MB fixed ] 

c67f [ cdd 67MB fixed ] 

d300 [ 300MB Capricorn ] 

dl9r [ 19MB Lark removable J 

dl9f [ 19MB Lark fixed] 

mt [ mag tape ] 



The drive number is if the standard address is used 
(normally FC/PB/FO for device, controller, and selch 
respectively for discs, and C5/F0 for device and selch 
for tapes), and "*" otherwise. If a "*" is used, you 
will be individually prompted for those three values, 
which should be two digit hexadecimal numbers in upper 
case. The controller is irrelevant for mag tape units, 
so any value will do. In this document, most examples 
assume non-standard addresses, since the majority of 
system devices are configured at non-standard 

nfv^nf/o^^ f?^'^^^' , jgjLSioEt^ .and x^spfinssjs JLqjl 
^s^us^/ f^QntiQUQL /s^lsh siLe not. shoMH. 

The offset from the beginning of the pack is given in 

512 byte blocks. The most commonly used values are 

/tmp file system), 19200 (root file system), and 28800 

(/usr file system) . 

For example, the notation d67 (0,19200) refers to the 
root file system of a 67MB disc at standard addresses. 

Each line typed should be terminated by a carriage 

return. if a mistake is made while typing, the character 

# or backspace erases the last character typed on the 

current line, and the character •§• erases the entire line 

typed. 

Some consoles cannot print lower case letters; adjust 
the instructions accordingly. 

When creating file systems, the correct number of 
blocks per track must be known. The appropriate values are: 
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80 for 667 and c67f 

304 for d256 

16 for cl3r and cl3f 

48 for c40f 

256 for d300 

31 for dl9r and dl9f 

fi- INSTATJ.ftTTOl? E£m TA£JE 

track^^lS'BPi'^nd'c^^LxTthl'foi^ ''' ^^^ or 9- 

tapemarks: contain the following files, separated by 

File 0: (80-byte records) 

Edition VII hstoi^ie) program, 

loadable by "50 Sequence" 
File 1: (256-byte records) 

foin^K^ ^K^ ^^^^^^ program, 

loadable by lsu (3200 series) 
File 2: (Ik-byte records) 

Standalone iBUfi(l) program 
File 3: (Ik-byte records) 

FilP^l!"^^^?!?\-^^^^^^^^^ program 
File 4: (Ik-byte records) 

pno^^^"'^^i?f?\^^^^^^^^^^^i^ program 
File 5: (Ik-byte records) 

Standalone M]2(l) program 
File 6: (20480-byte records) 

'/no..4??^°~^i't® records) 

File s" nnotn^i^t'' ^" ^^^^^ f^^^^t 
i/i' ^. ^^0240-byte records) 
/ filesystem in JUxd) format 

Mount the distribution tan** a<- i^«^ 

hardwfff c^Lx^^r^^^fL^^'^.a^CLs^^^:^^ f ^^^^"^ - 
ice codes and "standard" har^war^ =22 ^^^°'* describe dev- 
tion device addresses may be duLrfnt!'^*^' ^"''''^ installa- 

fi.1.1.1. LfiadijOg 'JaOOt' from T;4no tria men 
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A. 



Use the Display Panel to initialize low-memorv 
device definitions as follows. memory 

Address Value Meaning 



l^ ^500 al x'CF' auto-load 

52 OOCF 

li 4300 b x'80' branch to 

78 IT. loadedprogram 



xxyy 



XX = address of input device 

(see Table 1 below) 

yy = device READ command 



B. Clear the PSW status to zero [DTA-0-FN-SEL] . 

C. start execution at address x'50» [DTA-50-ADR-RUN] 

^C3M£ 1_L Standard J^O Seauenr^" I>g:ri£:o^ 

Device READ Device 
Address Command 



02 


94 


13 


99 


45 


Al 


85 


Al 


C5 


Al 



Teletype reader 

Paper tape reader/punch 

Cassette tape 

Magnetic tape at address 85 

Magnetic tape at address C5 



^' '^rl'iJ^^ '?^K ^"^^""^ *^^ ENABLE and press the 

llr.IV ^''tu''^' "" ^^^^ ^f ^^^i<^^ mnemonicrshould 
appear on the console, followed by the prompt 



DEVICE= 



B. If the boot device is configured with "standard" 
device, controller and selch addresses, enter the 
corresponding device mnemonic from Tabl4 2 below^ 
otherwise enter 'OTHR'. oeiow. 



C. 



If 'OTHR* was specified above, respond to further 
prompts as applicable. turther 
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device address ^^ 
device type code H-0 
controller address ^ 
selector channel address"^ \ 



D. Respond to the prompt 

FILEMARKS* 

with the decimal "1" (this is the number of 
to skip on the standard distribution tape). 
Suable 2: Standar^^ i^ Devicg>ff 



files 



450R0r^ ^YltV flu'^'^t "?i^ 1^^"^ Programming Manual 29- 
4DUR01. Your LSU default addresses may be differpni- nZ^ 
following is the defaults used by the bootstrap! ^^^ 



LSU 
Mnemonic 

DS5F 
DS5F 
DS5R 

DS67 

D256 

C13R 

C13F 

C40F 

C67F 

D19R 

D19F 

D300 

MG85 

MGC5 



Device 
Code 



Device 
Address 



Controller 
Address 



Selch 
Address 



Device 



31 

32 

33 

34 

35 

36 

3B 

3C 

3D 

3E 

2A 

2B 

2C 

40 

41 



C6 

C6 

C6 

FC 

FC 

FC 

FC 

FC 

FC 

FC 

FC 

FC 

FC 

85 

C5 



B6 
B6 
B6 
FB 
FB 
FB 
FB 
FB 
FB 
FB 
FB 
FB 
FB 



FO 

FO 

FO 

FO 

FO 

FO 

FO 

FO 

FO 

FO 

FO 

FO 

FO 

FO 

FO 



2.5MB disc 
10MB disc (fixed) 
10MB disc (removable) 
40MB disc 
67MB MSM disc 
256MB MSM disc 
13MB CDD Cartridge 
13MB CDD Fixed 
40MB CDD Fixed 
67MB CDD Fixed 
19MB Lark Removable 
19MB Lark Fixed 
300MB Capricorn 
SOObpi magtape 
1600bpi magtape 



us»^Vh» ^^^ ^^°° ^"^"' ^° ^°^^ ^'^°'» 2.5MB or 40MB disc 



■ spectively. 



^•1.2. Verify ing iM UK Bootioar^^r 

After the bootstrap has been 
console will type 



successfully loaded the 
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If instead of the fififlt-lX message the console displays 
a ">" sign, microcode, or the wait light remains con- 
tinually dim, follow the instructions given in Table 3 
to initialize memory. 

TSibls. 1: Hacliinfi Code lox Initializing hsmoa*'' ' 

To initialize memory press the halt switch on the sys- 
tem and type in the following machine code: 



@100 


F840 






ei02 


0004 






@104 


0000 






@106 


2454 






§108 


F860 






@10A 


OOXX 


[XXFFFC = top of core] 




@10C 


FFFC 


[XX is in 64k byte units. 


values are:] 


@10E 


5044 


[03 = 256k] 




8110 


0000 


[07 = 512k] 




§112 


C140 


[OF = Imb] 




§114 


FFF8 


[IF = 2mb] 




§116 


8800 


[3F = 4mb] 




P 








= 

< 









Then press the enable and init switches on the system, 
and reboot. 

If the system refuses to leave microcode, press the 
halt switch and type in the following: 



§0x84 

§0x86 

P 

=0 

< 



5000 
6000 



£.2.. 



Now press the enable and init switches on 
and reboot. 

ths. Root ElliL System 



the system^ 



*Perkin-Elmer Field Information Bulletin 209 
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£•2.1. liaMug ihs. RQPt Ells. S^£^sm 

Make an empty file system by running the mkfs program 
as follows: 

[to bring in the program mkfs] 

: mt(*,2) 

Mk.f s 

Ills system slzsi (Ui-l2yt£ i2li2£k£} 4800 

Ills system; d67(*, 19200) 

IsJjLe » ZX 

blocks mx. cylinder (n) : 80 

m/n = XX 
[after a while] 
£xiut £all&d 
BOQt-Ui 



The correct value for blocks per cylinder can be found 
in section 2. 

^-Z>2. Copying in ths Root Ells S^istsm 

The next thing to do is to restore the data onto the 
new empty file system. To do this you respond to the ':* 
printed in the last step with 

[to bring in the program restor] 

: mt(*,3) 

E££tiUL 

tape? mt(*r6) 

disK? d67(*, 19200) 

Hit ^ETiiEM Ji£y When ready Ilq isslsixs Ila MsJi. 

[the tape moves, perhaps 5-10 minutes pass] 

sM Ql tape 

Boot-IX 



You now have an Edition VII root file system on msmOc. 

£.1. Booting Edition Yll 

You should have the bootstrap running, left over from 
the last step above; if not, repeat the boot process [sec- 
tion 3.1] again. Then enter 

: d67(*, 19200) edition? 

The machine will type the following: 
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jgslltlim ^m software isn. ii££ sm ££IJ £££l^ Hufflls^j: jsjl&xk 

iUKl£j: license numb^i. juuul& mU^ Ths. Ssxkln-ElmsLL corporation 
Copyright Ths. ^sjiKin-Elm^i. Corporation liL&l 
Ml rights r es e rve d 

JiQic Ikfi hs. construed ^g s published work ^ ~ 

May not l2£ copied without permission M p^xiLin-Ujoei. 
Memory » x^u^.^ui £ 
« 

The memory message gives the memory available to user pro- 
grams in kilobytes. 

Edition VII is now running, and the 'Edition VII 
Programmer's Manual' applies; references below of the form 
X(y) mean the subsection named X in section Y of the manual. 
The '#' is the prompt from the Shell, and indicates you are 
the super-user. The user name of the super-user is 'root', 
with no password required, HOWEVER f hs. sure ij5 .S£t 5 pass- 
3£sxil (£££ passwd(l)) a£ soon jas po ss ible j^ your system josy 
h^ co m promise d ! 

£.1. Setting iip /iJOPr /llr ajld Restoring /iisx 

£.1.1. Creating 1J]£ /t m p £il£ system 

Next make and mount a file system for /tmp. This can 
be done by typing the following commands 

/etc/mkfs /dev/rmsmOa 4800 8 80 
/etc/mount /dev/msmOa /tmp 

The correct number of blocks per cylinder can be found 
in section 2, 

&.I.2. Putting thSi B o ots tr a p sm Riss. 

Before anything further is done the bootstrap program 
should be copied to the disc. This is done by using the 
command 

/etc/mkboot -9600 /boot /dev/msmO 

Now the Per kin-Elmer LSU bootstrap is usable. See boot (8) 
for further information. 

&.I.I. Creating JfeM /ii Ells. Sy s te m 

It is wise to create a file system separate from "root" 
and "usr" for the users' files to reside. Use the following 
commands to make the file system then mount it. 
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/etc/mkfs /dev/rmsmOe 25600 8 80 
/etc/mount /dev/rosmOe /u 



£.A.i. Creating thsi /h&l E11& Systein 

The next thing to do is to restore the Vusr' file sys- 
tem from the tape. 

/etc/mkfs /dev/rmsmOd 25600 8 80 



At this point mount the '/usr' file system (mount(8)), 
change to the /usr directory (cd(l)), skip 7 files on the 
tape, and use tar to read the tape (tard)). To do this 
type the following: 

/etc/mount /dev/msmOd /usr 

cd /usr 

tpc ff 7 [skip 7 files on the tape] 

tar xvp [extract the 'usr* file system] 

Now unload the tape and store it in a safe place. 

£.j^. ijoading iSy st gtn source 

This section applies onXy ^ those installations with 
sy ste m sour ce. 

To load system source, load the second tape with the 
'write' ring removed, and restore the files as follows 

mkdir /usr/src 

cd /usr/src 

tar xvpf /dev/rmmtO 

mkdir /usr/doc 

cd /usr/doc 

tar xvpf /dev/rmmtO 

The tape will advance for several minutes. When it 
completes, remove the tape from the drive and store it in a 
safe place. The layout of source is described in "Regen- 
erating System Software" and the hier(7) manual page. The 
/usr/doc directory contains most documents in volume 2 of 
the Edition VII Programmer's Manual. It may be removed from 
the system to save space (about 1MB) . 

Sl»S.. Example 3l lo ad i n g from tape & booting lism &n d67 

disc 
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JQE£I££=OTHR 

J2Ey#=85 

£QI2fi=40 

£Ii£ii=Fl 

FIIiEMARKf>=l 

: mt(*,2) 
Mliia 
Hie jBi:£i£iD .aizfi: (lX-]2yt£ Mficks) 4800 

illSL ^yfiiejD: d67(*, 19200) 

interleave (m) ; 8 

lalQfilLS pei cylinder (n) : 80 

m/n = XX 
exit £SilM 

BPQt-iK 
: int(*,3) 

£e£JLfii: 
tape? mt(*,6) 

iiisJt? d67(*, 19200) 

flit EEIIIEN jLey jathen ready ist xe^tiLce ts Mjsk. 
end Ql tape 

BO Ot -Ui 

; d67(*,19200)edition7 

Mitifin Yii £<iftmc£ ixu: iise xm ££li £exiai JSiimbejL xxxxx 

r^,.., --^^Sf^u-^^^^^ immbex juliuus xitli iEiifi PexMn-filmex corporation 

CQ p ygxght TM £e£jsLui-£lineiL CQcpQiration i2M 

Ali XASilta reserved 

l^Q^ is h& construed SS. ^ published work 

mx not l2e copied without permission sil PexJOn-Eljnei: 
Meinory = xxx.xx JL 

# /etc/mkfs /dev/rmsmOa 4800 8 80 

# /etc/mount /dev/msmOa /tmp 

# /etc/mkboot -9600 /boot /dev/msmO 

# /etc/mkfs /dev/rmsmOe 25600 8 80 

# /etc/mount /dev/msmOe /u 

# /etc/mkfs /dev/rmsmOd 25600 8 80 

# /etc/mount /dev/msmOd /usr 

# cd /usr 

# tpc ff 7 

# tar xvp 

[Following commands for source only] 

# mkdir /usr/src 

# cd /usr/src 

# tar xvpf /dev/rmmtO 

# mkdir /usr/doc 

# cd /usr/doc 

# tar xvpf /dev/rmmtO 
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1. TNSTALLATION SBQH £DD REMOVAB L E ULiC 

This section describes the procedures to use when 
installing Edition VII from a CDD 16MB (unformatted capa- 
city) removable disc. This disc is generally referred to as 
a C13R (which stands for Cdd 13mb (formatted) Removable)^ - 

The C13R disc is set up in a manner essentially similar 
to that of a distribution tape. It contains the following 
four disc sections: 

msmO a; Standalone boot program, pointed to by volume header 
(60-512 byte blocks) 

msmOb:File system with standalone boot, adb, icheck, mkfs, 
restor (340-512 byte blocks) 

msmOc:Root file system in dump(5) format (about 4000-lK 
blocks) 

msmOd:/usr file system in dump(5) format (about 8100-lK 
blocks) 

2-1. Starting iJae 1^ BootlQader 

To bring the system up, insert the C13R cartridge into 
the drive (which is generally at address FC/FB/FO for device 
address, controller address, and selch address, respec- 
tively) and bring it up to speed. Set the protection switch 
to ON for the upper (removable) portion. If you are restor- 
ing to the lower (fixed) portion, set the protection to OFF 
for that disc. When it is ready, bring in the Ik bootloader 
as discussed under tape loading using either the 50 Sequence 
or the LSU (see section 3.1). The 'normal' case (i.e., with 
an LSU and the disc at the standard address) requires 
depressing the ENABLE and INIT buttons, and responding to 
the DEVICE= prompt with 'C13R' and the FILE= prompt with 
'BOOT'. The system should respond 

Boot-Ik 

If you do not get this message, see the section 3.1.3 for 
how to initialize memory. 

1.2. Buim. in Root Ell£. System 

l.Z.l. creating Ji^M ROOt E11& Syst e m 

First, make an empty root file system with the follow- 
ing procedure: 
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[to bring in the program mkfs] 
: cl3r(*,60)mkfs 
Hklfi 

lilfi system slz^: (Ut-JaiOLe MiifiKfi) 4800 
Ills. ^y&tSffi: d67(*, 19200) 
IStlZS. "= 2X 
interleave (iq) : 8 
Mfi£jLS ££JL cylinder (n) : 80 
JB/n = XX 
[after a while] 

BQQt-lk 



See section 2 for the correct value for blocks per 
cylinder. You now have an empty root file system. 

2»2.2. Restoring ilm Root ills, system 

Next restore the contents of the root file system using 
the standalone restor program: 

[to bring in the program restor] 

: cl3r(*,60)restor 

Restor 

tape? cl3r(*,400) 

MmK? d67(*, 19200) 

Hit EETURM Ji£y Mhsn ready i£ issi^suLS ^ iiisJi. 

[10-15 minutes pass] 

find of tape 

Boot -lk 

• 

You now have a root file system. 
2.1. Bring In /iisr zil^ system 
2.1.1. Create ths /h&l Ells system 

First build the file system using the sequence: 
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[to bring in the program mkfs] 

; cl3r(*,60)inkfs 

JUsJLs 

liliB fiXfij;£lD 3lZ&i (JA-totfi JaliifiJLS) 25600 
m^ ^ysi^Lffi: d67(*r28800) 

interleave (iq) : 8 

Mi2£Jl& Si&L cylinder (n) : 80 

[after a while] 
£2jLi; called 

Boot-lX 



2.1.2. Reigtore jtM /ii££ £ilfi ^i^sJism 

Now restore the contents of the /usr file system: 

[to bring in the program restor] 
: cl3r(*,60)restor 

tape ? cl3r(*,9400) 
disk? d67(*, 28800) 

Mi Kswm Jtey Mhm x^adi^ ifi xfistfii^ is iLLsJi. 
[20-25 minutes pass] 
sn^ Sil ta pe 

• 

You have now created the /usr file system. 

2.4. Booting Edition ^lll 

You are now ready to bring up Edition VII in single- 
user mode. Use the following command: 

: d67(*,19200)edition7 

The machine will type the following: 

Udiiion :ill Software Iflx iass jon ££ll fifijLial liumbfix is;xxxx 

iinder JJ^sasfi number juuuut iLiili j^hs ££xian-£lmfii corporation 
Copyright TM BsxJsjLn-Elm^ Corporation 2M1 
All r xghtS reserve<3 
13fit i^ h£L construed as a published work 

llay: jiejt hs. C QP i e d without permission i2f PfixJOn-Elffiei: 

■Memory « j&kx.jul X 

I 

The memory message gives the memory available to user pro- 
grams in kilobytes. 



04-164M95R04 2/84 



- 20 - 



Edition VII is now running, and the "Edition VII 
Programmer's Manual' applies; references below of the form 
X(Y) mean the subsection named X in section Y of the manual. 
The '#• is the prompt from the Shell, and indicates you are 
the super-user. The user name of the super-user is 'rootl., 
with' no password required, pOWEVER , hs. M11L& i^^ ££t A pass- 
word (£fi£ pajsLSMdd)) as sqqh as. possible iit yfiui: system may 
lie compgQmisecli 

2.^. Setting up /iiDP and /n. Creating a Baot BlsisK 

1.5..1. Setting iip /ijap Ells. .System 

The next step is to create and mount a file system for 
/tmp. This can be done as follows: 

/etc/mkfs /dev/rmsmOa 4800 8 80 
/etc/mount /dev/msmOa /tmp 

2.^.2. Setting iip /ii Ells. System 

Now create the /u file system: 

/etc/mkfs /dev/rmsmOe 25600 8 80 
/etc/mount /dev/msmOe /u 

2.^.1. Cr eate a Boot Block 

Now create a boot block. This is extremely important, 
as you will not be able to boot directly from your system 
disc until you have a boot block. Use the command 

/etc/mkboot -9600 /boot /dev/msmO 

The Per kin-Elmer LSU bootstrap is now usable. See boot (8) 
for further information. 

Now execute a couple of sync (2) commands to flush out 
all data and then spin the disc down. Remove the cl3r disc 
and store it in a safe place. If you do not have source, 
insert a new disc, turn the write protect to OFF, and spin 
the drive back up to speed. 

!.£.. Loa ding System Source 

This section applies only ^ those installations Mith 
i?ystem sou r c e . 

To load system source, load the second disc and spin it 
up to speed, and restore the files as follows 
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rokdir /mnt 

/etc/mount /dev/msml /mnt -r 

mkdir /usr/src 

cd /usr/src 

tar xvpf /mnt/source 

mkdir /usr/doc 

cd /usr/doc 

tar xvpf /mnt/documents 

/etc/umount /dev/msml 



Depending on your conf igurationr the removable disc may 
have a name other then msml • You can verify the correct 
name by looking in your configuration file for the cl3r 
disc. You can verify the correct disc by doing an fsck(8) 
on the disc, and if it does not have any errors mounting the 
disc. If it is the source disc, there will be a large file 
called 'source' and another called 'documents' on the disc. 

The source will be copied in for several minutes. When 
it completes, execute a couple of sync (2) commands to flush 
the buffers and spin the disc down. Then remove the disc 
from the drive and store it in a safe place. Insert a new 
disc in the drive, turn the write protect to OFF, and spin 
the drive back up to speed. 

The layout of source is described in "Regenerating Sys- 
tem Software" and the hier(7) manual page. 

2.2. Example ol Loading from ni&s^ & BQQting Iism slr n51 



04-164M95R04 2/84 



- 22 



I2JEXI££=C13R 
5i[QIi=£JQZf £JLE=BOOT 

: cl3r(*,60)mkfs 

lil£ sys t e m slz&i ilk-lscii^ hlst£]s^) 4800 
file ^ystfiffi: d67(*rl9200) 

,X,S,il Z Q ~ jStJot. 
interleave (ffl) : 8 

i;di;>£lLS £&£. cylinder (n) : 80 

m/n = XX 

exit £SLlle^ 

BoQt-Us. 

: cl3r (*,60)restor 

RestQj: 

tape ? cl3r(*,400) 

disk? d67(*, 19200) 

lilt fiEIIlEJS Jisy When ready Jifi restpre i;^ iiisK. 

£iid M tape 

Boot - lk 

! cl3r(*r60)mkfs 

file system slz£: (Ui-byte MssJis) 25600 
file s ystem ; d67(*r28800) 

IfiiZje = XX 

interleave (jn) : 8 

blocks £ei cylinder (n) : 80 

m/n = XX 

exit .called 

Boot-lk 

: cl3r (*,60)restor 

Res tc r 

i3£e? cl3r(*,9400) 
dl^? d67(*, 28800) 

flit £EmEN ii£Y When ready t£ restore ie Msk. 

: d67(*rl9200)edition7 

Edition itil Softwa re Ifix iis^ i>n £EI1 Serial Number xxxxx 

under license nu m b e r xxxxx with Ths. PexMn-EIiaej: CcrppratAon 
Copyright Ths. S^xKin-Elmsi. Ccrporaticn IMl 
AH rights reserved 

Not to be construed ius ja Published work 
May not be copied without permission 9l PfiJLkin-Elinej: 

Me mo ry = xisx.xx K 

# /etc/mkfs /dev/rmsmOa 4800 8 80 

# /etc/mount /dev/msmOa /tmp 

# /etc/mkfs /dev/rmsmOe 25600 8 80 

# /etc/mount /dev/msmOe /u 

# /etc/rakboot -9600 /boot /dev/msmO 
[Following commands for source only] 

# mkdir /mnt 

# /etc/mount /dev/msml /mnt -r 

# mkdir /usr/src 

# cd /usr/src 
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# tar xvpf /mnt/source 

# mkdir /usr/doc 

# cd /usr/doc 

# tar xvpf /mnt/documents 

# /etc/umount /dev/msml 

&. INSTA LLATTO N EBQh LAEK REMOVABT. r nugfi 

This section describes the procedures to use when 
c?tv? iiilLif ^i-'' V^^?^o"» ^ ^^^^ 25MB (unformatted capa- 
a dIsr ?lf tL ;^fo: •''^^^fif^i^ generally referred to^as 
a D19R (as the disc is a 19MB (formatted) removable pack) 
thP^tSf tii^^i?'' procedure is typically used on 32ols^wSer; 
tern disc. portion of the disc) is used as the s^s- 

The D19R disc is set up in a manner essentially similar 
thref disclections:''"''"" '"^' '' ^""'^^'^^ ^^^ following 

msmOa:Standalone boot program, pointed to by volume header 
ril^'JlK I J^^^^^?^ ' P^"s a file system with stan- 
blocks) ' *"' ™*'^^' restor (340-512 byte 

msmOb:Root file system in dump(5) format (about 4000-lK 

OJLOCRS ) 

H.sinOc:/usr file system in tar(l) format (about 8100-lK 
blocks) 

a.i. Starting iie li BootioariPr 

^h«. A^° bring the system up, insert the D19R cartridge into 
the drive (which is generally at address FC/FB/FO fof device 
l^tl.lV T^roller address, and selch address, relpec- 

^i nx/L''"!''""^ ^^ "P '^o «P^«^- set the protection switch 
to ON for the upper (removable) portion, if you are rfstor- 

fo? th»t''^?«i°"^L'"-f*^^ portion, set the protection to OFF 
:=^=l5^oS ^%^- J^^^ ^^ ^^ ■'^^^y' ''ring in the Ik bootloader 
of fh! T^o^f ""'^" ^^ loading using either the 50 Sequence 
an Lln^ni^^^v.^^''^-°" ^'^^ " ''^^ 'normal' case (i.e!? with 

prei^ing"^he"KN«Bf^%^dlKx^'^but?^^2?"f„|^''^li;L^r„f^^^ 

^^So^r^^s; sf^t^rshoL^s .:%'^. -^ -^ "- -"-"wi^h° 

Boot-Ik 

llJll fM?*?^.?^*" ^^^^ message, see the section 3.1.3 for 
now to initialize memory. -^.a.j j-ut 
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a,2. fixins In Root £ilfi gystem 

£•2.1. Creating ilifi ROQt £il£ fiXfitfilD 

First, make an empty root file system with the follow- 
ing procedures 

[to bring in the program mkfs] 
: dl9r(*,0)mkfs 

MkutS 

tils, s ystem 3lz&i (IX-byte JaliLCkS) 4800 

iil£ system: di9f (*,0) 
isize = XX 
interleave (ffi) : 8 

bJjQcJsLS pfiJL cyXindeg (n) •• 31 
m/n = XX 

[after a while] 

exit called 



See section 2 for the correct value for blocks per 
cylinder if you have other than a D19F as a system disc. 
You now have an empty root file system. 

B..Z.1' Restoring ths. RQOt Ells. System 

Next restore the contents of the root file system using 
the standalone restor program: 

[to bring in the program restor] 
: dl9r(*,0)restor 

Restor 

tape? dl9r(*,9600) 

disk ? dl9f(*r0) 

liii RJEJURH Jifiy When x.eady is restore tQ iiisJi. 
[10-15 minutes pass] 
qM stl tape 

You now have a root file system. 
SL.l. Booting Edition yxi 

You are now ready to bring up Edition VII in single- 
user mode. Use the following command: 

: dl9f (*,0)edition7 

The machine will type the following: 
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miti^n 501 5fift3tfai^ lat U3& sm £m SsjOslI mshsuL £2lj^^ 
Copyright SM Ssu^Jsan-ElmL CocpQgatiQn 12jai 

All XlSllt£ reserved 

liQi ifi ]2fi constrttgd as a publiBhed work * - 

W imt lie iSfiEied without permission ijf PeiJuji-fiUnfii. 

» 

The memory message gives the memory available to user pro- 
grams in kilobytes. 

Edition VII is now running, and the 'Edition VII 
Programmer's Manual' applies; references below of the form 
X(Y) mean the subsection named X in section Y of the manual 
The •#• is the prompt from the Shell, and indicates you are 
the super-user. The user name of the super-user is 'root' 
with no password required, jHQHEaiB, hs. Sliis J;i2 Sfit a pass- 
MQjLd (£££ paasjfida)) as sston as possible stL your system ffiay 
hs. o om pr omJ LsMi ^^ ^ ^" ^^'^^ 

Q.'A. Erlns in /hsj: £il£ system 

First build the file system using the sequence: 

/etc/mkfs /dev/rmsmOc 9744 8 31 

Now mount (8) the /usr file system and restore the con- 
tents from the removable disc using tar(l): 

/etc/mount /dev/msmOc /usr 

cd /usr 

tar xvpf /dev/rmsmlc 

Depending on your configuration, the removable disc may 
have a name other then msml . You can verify the correct 
name by looking in your configuration file for the dl9r 
disc. 

You have now created the /usr file system. 
t.5. jCrsatinci A Boot BIjqsK 

Lark based systems do not have /tmp file systems, so 




as 



Now create a boot block. This is extremely important, 
you will not be able to boot directly from your system 
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disc until you have a boot block. Use the command 

/etc/mkboot -9600 /boot /dev/msmO 

The Perkin-Elmer LSU bootstrap is now usable. See boot(|) 
for further information. 

Now execute a couple of sync (2) commands to flush out 
all data and then spin the disc down. Remove the dl9r disc 
and store it in a safe place. If you do not have source, 
insert a new disc and spin the drive back up to speed. You 
can then create a /u file system on the removable disc. 

&.£.. Loading System sowgce 

TMs .B££i;iim applies iMiIy i^ iJ^^ installations mXh 
gystem source. 

To load system source, load the second disc and spin it 
up to speed, and restore the files as follows 

mkdir /mnt 

/etc/mount /dev/msml /mnt -r 

mkdir /usr/src 

cd /usr/src 

tar xvpf /mnt/source 

mkdir /usr/doc 

cd /usr/doc 

tar xvpf /mnt/documents 

/etc/umount /dev/msml 

As mentioned in section 8.4, the removable disk may be 
other than msml . The correct value can be found in the con- 
figuration or you can verify the correct disc by doing an 
fsck(8) on the disc, and if it does not have any errors 
mounting the disc. If it is the source disc, there will be 
a large file called 'source' and another called 'documents 
on the disc. 

The source will be copied in for several minutes. When 

it completes, execute a couple of sync (2) commands to flush 

the buffers and spin the disc down. Then remove the disc 

from the drive and store it in a safe place. Insert a new 
disc in the drive and spin the drive back up to speed. 

The layout of source is described in "Regenerating Sys- 
tem Software" and the hier(7) manual page. 

8..1. Example ol Loading from LaxJi Removable & Booting £xsm 
^ hsjLK Fixect di&S: 
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lifflI£JB»D19R 
yOL^JSnif £1L£=BCX)T 

: dl9r(*,0)mkfs ^ _ 

Ills system &lZ£: (U&-Jt2y:t£ J2lfi£k£) 4800 
tils, s ystem : dl9£(*,0) 
lsl2£ " ^ 

i n t ecl eave (m) : 8 

M^^£k& SiSUL cylinder (n) : 31 

ffi/n = XX 

£iLLt £all£d 

BQQt-USt 

: dl9r(*,0)restor 

Restor 

tape? dl9r(*,9600) 

iilfiii? dl9f(*,0) 

Eit ESTUM Ji£y When ready is usisi^oi^ is iiisk. 

BQOt-lJL 

: dl9f (*,0)edition7 

Mlilon Zli Software iiii iise an £B1 fifixlal ^luMifii ;uuuut 

iiM^ lliSfiasje numbtej: iuuQut Mltli llifi Perkin-Elmex corporation 
Copyrigh t IM PejLlLin-£liQ£x Cgrporatjlon IMl 

Ml XlslltS reserved 

Eoj; :t£ 12£ construed iL£ a published work 

My imt M copied without permission M JEfixMn-filmex 
Memory: = jljl&.jlx E 

# /etc/mkfs /dev/rmsmOc 9744 8 31 

# /etc/mount /dev/msmOc /usr 

# cd /usr 

# tar xvfp /dev/rmsralc 

# /etc/mkboot -9600 /boot /dev/msmO 
[Following cominands for source only] 

# mkdir /mnt 

# /etc/mount /dev/msml /mnt -r 

# mkdir /usr/src 

# cd /usr/src 

# tar xvpf /mnt/source 

# mkdir /usr/doc 

# cd /usr/doc 

# t^r xvpf /mnt/documents 

# /etc/umount /dev/msml 

3l. customizatiqu 

^.1. Reconfiguration 

The EDITION VII system running contains the system 
described in your configurator. This should include your 
first six discs, up to three tapes, and up to six communica- 
tions multiplexors. The line speeds may be wrong. You may 
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need to alter the configuration file to reflect the true 
state of your machine. 

It is wise at this point to know how to ,"n^i9ure the 

system. Print (cat(l)) the ^"^/""/^yf/S .f ^^^^l^la 
This' file is input to the program malifid) which if invOKea 
with -mike all- will recompile all of the system source and 
install it in the correct libraries. 

The program mkconf(l) prepares files that describe a 
given configuration (See mli£finf dm) ) . In the /usr/sys/conf 
directory, the file -conf.xxxxx' was input to mkconf to pro- 
dice the version of the system in /edition?. You will need 
to Idit it to describe your own configuration. Then run 
mkconf- it will generati the files param.s (assembly parame- 
ters) and cc (configuration tables) . Take a careful look 
at Ihlse files to make sure that all the devices that you 
have are included at the right addresses. 

After all the corrections have been made, use make(l) 
to recompile the system (or recompile individually if you 
„<=!,, nsp the makefile as a guide). If you compiled indivi- 



wish: use the makefile as a guide). If you compiiea ^^aiwx- 
dialiy, say 'make edition? • in the directory /usr/sys/conf. 
The final object file (edition?) should be moved to the 
root, and then booted to try it out. It is best to name it 
something like /nedition? so as not to destroy the working 
system until you are sure it works. Or boot it from the 
current directory with : 

d67 (*, 28800 ) sys/conf /edition? 

see fcfi2t(8) for a discussion of booting, f^e: before tak- 
ing the system down, always (It) perform a sync(l) to force 
delayed output to the disc. 

S..2. Special £il£S 

Next you must put in special files for the new devices 
in the directory /dev using mknod(l) . ™® ,, ^t^ 
/usr/sys/conf /mkdev.sh (created by mkconf) will g^^^ y°«.,^" 
idea of how to create special files. Do not use this file 
without prior examination, as it is not complete, /o" ^^n 
aiso p?int the configuration fil^^.c created above, 
although this method is somewhat more difficult, C.c is the 
major device switch of each device class (block and charac 
ter) There is one line for each device configured in your 
lylt^m and a null line fo^Pl^<=e folding for those devices 
not configured. The essential block special J^^f J^f" 
inct-alled above! for any new devices, the major device 
nS^blr'lf selecUd by counting the line number (from zero) 
Of the device's entry in the block configuration taDie. 
?hus the first entry in%he table ^devsw would be major dev- 
ice zero. This number is also printed m the table along 
the right margin. 
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Dartlt?on"'«°H«fr-K^^^^ ^^^ "^"^^'^ """^«'^' ""it number or 
partition as described under each device in section 4 of the 
manual. You can also add entries for other disc drives! 

-In reality, device names are arbitrary, it is ususirv 

do^^n^v^K*' ''°. l!^^\ = ^y^*^*" f°' deriving namfs, but it 
doesn't have to be the one presented above. 

^,.=^ °^"'? further notes on minor device numbers. The 10MB 

fnH?o,f"''K^K"°^^ ^^^ °" ''" °f the minor device number to 
indicate whether or not to interleave a file svstem a^rosc 
more than one physical device. See dskU) fof more detli! 

not Vo^T.Jna"%y,rr ''\°'°? ""^^ ^'' indicate whither i; 
?fL "y^2^, the tape when it is closed. By convention 
tape special files with the 0200 bit on have a 'm- pripended 
Itut. '""'^' ^^ '" /dev/mmtO or /dev/rmmtl. Again? sif 

devices^ "Her2^th^ n^^ir*"" <3«'i«s is Similar to block 
HlTtSff* ''^f^^the names are even more arbitrary except that 
devices meant to be used for teletype access should (to 
avoid confusion, no other reason) be named /dev/ltyx, where 

sole Tm 1™»:^ i^^ ^",;°°' °^'lib"ry•). The files co" 
sole, mem, kmem, and null are already correctly configured. 

The disc and magtape drivers provide a 'raw' interface 
to the device which provides direct transmLs^on between thi 

largeMcords"" The rf'^ ^"' "''°^^ ^^^'^i"^ or writing 
and sh«^?S K lu '^^^ device counts as a character device, 
speciarffle 3?th Tr^""^ °^ ^^% corresponding standard Wock 
wou^d be called 5deWri^^vP^"^K'^• '■'^"^the raw magtape files 
made? '^^^^^^ /dev/rmtx. These special files should be 

shouid'^^he^^i t^^ special files have been created, care 
these fne« l^ ^° .°^^"9e the access modes (chmod D) on 

these files to appropriate values (probably 600 or 644). 

4.2. liffifi Conversion 

If the system reflects the incorrect timezone this can 
the orfier^f- ''y.f^jting /usr/sys/conf/conf.xxxxx to riflect 
hourl^ ?o,^;!;nn ^i?^"«"°^ between local time and GMT in 
p^T ; <=„ ^m" ^''i"'* ''°"^ values include for GMT, 5 for 
EST, 6 for CST, 7 for HST, and 8 for PST. If dayliaht savf 

va?L ^^"'^,, ^"^n. " "^^-^ i" y°« «ea, set the -daylight- 

In the SI r"^'^»t^^i°" "J^ '^°.^- ''°^^ tha? Dsl'' wirks 
rSles)! •^•*" ''"t may not work elsewhere (due to varied 



S..A. Eific Layout 



frhe .^L"'®^®/"^ ^° ''^ '"°'^® ^^^^ systems mounted than iust 
the root and /usr, use mkfs(l) to create any new file syitim 
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and put its mounting in the file /etc/rc (see init(8) and 
inount(8)). (You might look at /etc/rc anyway to see what 
has been provided for you.) 

There are two considerations in deciding how to adjust 
the arrangement of things on your discs: the most impor«knt 
is making sure there is adequate space for what is required; 
secondarily, throughput should be maximized. Swap space is 
a critical parameter. The system as distributed has 9500 
blocks for swap space. This should be large enough so run- 
ning out of swap space never occurs. You may want to change 
these if local wisdom indicates otherwise. 

Many common system programs (C, the editor, the assem- 
bler, etc.) create intermediate files in the /tmp directory, 
so the file system where this is stored also should be made 
larqe enough to accommodate most high-water marks. If you 
leave the root file system as distributed (except as dis- 
cussed above) there should be no problem. All the programs 
that create files in /tmp take care to delete them, but most 
are not immune to events like being hung up upon, and can 
leave dregs. The directory should be examined every so 
often and the old files deleted. 

Exhaustion of user-file space is certain to occur now 

and then; the only mechanisms for c22^^?^^^I^Lwi t^ 
phenomenon are occasional use of dud), ^f^D' quot(l), 
threatening messages of the day, and personal letters. 

The efficiency with which Edition VII is able to use 
the CPU is largely dictated by the configuration of disc 
controllers. For general time-sharing applications, the 
best strategy is to try to split user files, the root direc- 
tory (including the /tmp directory) and the swap area among 
three controllers. 

Once you have decided how to make best use of your 
hardware, the question is how to initialize it. If jojj have 
the equipment, the best way to move a file system is to dump 
it (dump(8)) to magtape, use mkfs(l) to create the new file 
system, and restore (restor(8)) the tape. If for some rea- 
son you do not want to use magtape, dump accepts an argument 
telling where to put the dump; you might use another disc, 
sometimes a file system has to be increased in logical size 
without copying. The super-block of the device has a word 
giving the highest address which can be ^l^f^^ted. For 
Relatively small increases, this word can be Patched using 
the debugger (adb(l)) and the free list reconstructed using 
icheck(l). The size should not be increased Y^^^ JJ^^^JLi^ 
this technique, however, since although ^he allocatable 
space will increase, the maximum number of files will not 
(that is, the i-list size cannot be changed) . Read and 
understand the description given in file system(5) before 
playing around in this way. You may want to see section 
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msm(4) for some suggestions on how to lay out the informa- 
tion on MSN discs. 

If you have to merge a file system into another exist- 
ing one, the best bet is to use tar(l). If you must shrink 
a file system, the best bet is to dump the original and iffes- 
tor it onto the new filesystem. However, this might not 
work if the i-list on the smaller filesystem is smaller than 
the maximum allocated inode on the larger. If this is the 
case, reconstruct the filesystem from scratch on another 
filesystem (perhaps using tar(l)) and then dump it. If you 
are playing with the root file system and only have one 
drive the procedure is more complicated. What you do is the 
following: 

1 . GET A SECOND PACK 1111 

2. Dump the current root filesystem (or the reconstructed 
one) using dump(8) . 

3. Bring the system down and mount the new pack. 

4. Retrieve the Edition VII distribution tape and perform 
sections 3.1 through 3.2.1 (or 4.1 to 4.2.1) at the 
beginning of this document, substituting the desired 
file system size instead of 4800 when asked for 'file 
system size' . 

5. Perform section 3.2.2 (or 4.2.2) up to the point where 
the 'tape' question is asked. At this point mount the 
tape you made just a few minutes ago. Continue with 
section 3.2.2 (4.2.2) above substituting 'mt(0,0) ' for 
'mt(0,6)'. 

£-^. New HsfiiS 

There are two methods for installing new users: using 
the automated procedure mkuser(8), or by manually editing 
the password file /etc/passwd (see passwd(5)) and group file 
/etc/group (see group(5)). One of these procedures should 
be used once multi-user mode is entered (see init(8)). The 
following discussion applies to manual creation of users; 
the mkuser utility does all of these functions for you. 

First, you will have to make a current directory for 
each new user and change its owner to the newly installed 
name. A .profile should be placed in each users login 
directory to setup the desired system attributes (i.e. PATH 
). The default is PATH=/bin:/usr/bin:/usr/ucb: this will 
give you standard Edition 7 commands. Login as each user to 
make sure the password file is correctly edited. For exam- 
ple: 
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ed /etc/passwd 

$a 

joe; slO:l: s/u/joe: 

w 

q 

mkdir /u/joe 
chown joe /u/joe 
login joe 
Is -la 
login root 

This will make a new login entry for joe, who should be 
encouraged to use passwd(l) to give himself a password. His 
default current directory is /u/joe which has been created. 
The delivered password file has the user guest in it to be 
used as a prototype. 

!,£.. Multiple Uigegs 

If Edition VII is to support simultaneous access from 
more than just the console terminal, the file /etc/ttys 
(ttys(5)) has to be edited. To add a new terminal be sure 
the device is configured and the special file exists, then 
set the first character of the appropriate line of /etc/ttys 
to 1 (or add a new line) . Note that init.c will have to be 
recompiled if there are to be more than 100 terminals. Also 
note that if the special file is inaccessible when init 
tries to create a process for it, the system will thrash 
trying and retrying to open it. 

The /etc/ttys file is read each time the user enters 
multi-user mode. To enable a terminal which is listed in 
that file but has a first character of (indicating that 
the line is disabled), use the attach(8) command. Once a 
line is attached, it will be enabled until it is disabled 
using the detach (8) command, even if the system is rebooted. 

1.2. EULs S ystem Ji^sltli 

Periodically (say every day or so) and always after a 
crash, you should check all the file systems for consistency 
(icheck(l), dcheck(l), fsck(l)). It is quite important to 
execute sync (8) before rebooting or taking the machine down. 
This is done automatically every 30 seconds by the update (8) 
program when a multiple-user system is running, but you 
should do it anyway to make sure. 

Dumping of the file system should be done regularly, 
since once the system is going it is very easy to become 
complacent. Complete and incremental dumps are easily done 
with dump(8) . Dumping of files by name is best done by 
tar(l) but the number of files is somewhat limited. Finally 
if there are enough drives entire discs can be copied using 
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cp(l) , or preferably with dd(l) using the raw special files 
and an appropriate block size. 

l.£. jS^jSLt^m learning 

The UUCP and mail utilities are aware of the name^ of 
the system being run on. This name does not matter unless 
you are in a network of some sort, in which case you should 
edit /usr/include/whoami.h to have a seven character (or 
less) system name. Then connect to /usr/custom/mail and do 
a 'make cp' to install the new version of mail. Next con- 
nect to /usr/custom/uucp and do a 'make cp' to install the 
current versions of all uucp commands. Be careful not to 
delete the .o files in these two directories, as you will 
not be able to recreate these utilities without them. 

Users with source licenses can delete the /usr/custom 
directory, as those utilities can be created from 
/usr/src/cmd/mail and /usr/src/cmd/uucp. 

In addition, the special file /dev/culO should be 
linked to whatever port your dial-out line is plugged into. 
Special file /dev/cuaO is normally linked to /dev/null, as 
Perkin-Elmer hardware does not support CUA devices. Depend- 
ing on the type of dial-out modem you use you may not even 
need a /dev/culO line; this requires experimentation. The 
relevant programs to try this with are cu(lc) and uucp(lc) . 

£.1. Saving Space 

The Edition VII system as distributed contains a com- 
plete binary (and source, if applicable) . For those systems 
which are tight on disc space, there are various ways to 
reduce the amount of space taken by the system. They fall 
in two general categories; those files which are relevant to 
other systems and can be deleted, and those files which grow 
and should be trimmed periodically. 

Each Edition VII system has several copies of those 
programs which differ among different types of CPUs. Note 
that in each case the file names are foo.cputype (where cpu- 
type is 732, 832, 3205, 3210, 3220, 3230, 3240, and 3250). 
Do NOT delete foo, as it is needed, but foo.* may be deleted 
(since foo is simply a link to foo.cputype for the appropri- 
ate cputype) . It is, of course, a good idea to make a tape 
backup of any files before deleting them from the system. 
The following files fall into this category: 
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/bin/ps.* 

/bin/pstat.* 

/bin/adb,* 

/usr/ucb/w.* 

/usr/ include/sys/ local . * 

/usr/sys/sys/LIBl** 

/usr/sys/dev/LIB2 .* 



a normal 



The following files and directories grow on 
basis, and should be checked and trimmed regularly: 

/usr/spool/uucp/LOGFILE 

/usr/spool/uucp/SYSLOG 

/usr/tmp/* 

/tmp/* 
/usr/lib/learn/log/* 

/usr/lib/learn/play/* 

/usr/games/lib/snake* 

/usr/dist/spellhist 

in addition, the /usr/adm airectory -°«tains a number of 
files which grow on a regular basis. These inciuae. 

messages: log of system messages generated by dmesg(8) 
awkhist: log of awk(l) invocations i^vifRi 

?pr. error*: log of printer errors generated by lpd(8) 
suloq*: log of su(l> invocations 
wtmp*: log of login (1) invocations 

Those files marked with a * grow if they exist, but are not 
created by the corresponding programs if they do n°t exist. 
Othir programs may also use /usr/adm as a logging directory. 

The man(l) utility keeps f°^«'^"^5S. .f^^^^^ subsequent 
pages in /usrMan/catJ f,^|f---ge"need"nor Te'^rlfor- 
^t?rd!^°Sow^^e^^t^^an lareViteJbit of space Opt^ 

5°^ ^/''"/catl/2 'on ^f'reguttr'fs^s'or'r^m^vS^g the direc- 
/usr/man/cat?/* on a ^^^y"j;^t^"l^._ /, % yj^n reformat the 
tories altogether in «^^=^,^^^|if ^JU ?ormattld will take 
pages every time) . Keeping aii pageo 
over 1MB of disc space. 

Finally, various files can be moved from one l^^|tion 
to another depending where space IS available, in particu^ 

requires more care. Any V^^^-'-^^y,^"*^" "^ ..Jl^iities (e.g., 
tc^uxi.^ /bin, and some utilities vc.y.f 

user mode should be m /»^"' ?■' 4„ /bin 
login, sh, csh) arc expected to be m /bin. 
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i.Iil. Exismx Problems f Q£b3i£ sn^ Sn^ 

The files /etc/fstab and /etc/rc should be changed to 
reflect your normally mounted file systems if other than 
/dev/msmOa as /tmp, /dev/msraOc as root, /dev/msmOd as /usr, 
and /dev/msmOe as /u, (/dev/msmOa as root, /dev/msmOc as 
/usr for Lark-based systems) plus any other special things 
you want done on start-up. In addition, /usr/lib/crontab 
should be modified to execute those commands needed on a 
regular interval and /etc/motd should be set to your desired 
message-of-the-day. 

There are a number of known problems with Edition VII 
which can be easily avoided. If an off-line disc is 
mounted, the system will hang until the disc is brought on- 
line. Thus, only spinning discs should be mounted. If a 
disc being accessed is taken off-line, the system will hang 
until the disc is brought back on-line. 

For MAG machines only: MAC machines have an option of 
where the hardware MAC registers reside. This hardware 
selectable option is set depending on how many device 
addresses are in the system. The standard address of 0x300 
corresponds to the default value for 'ndevs' in the confi- 
guration file which is 256 (see mkconf(8)). The other two 
MAC addresses are 0x500 for 512 devices or 0x900 for 1024 
devices. Distributed systems contain an 'ndevs* value set 
appropriately for the highest hardware address genned into 
the system. If additional hardware addresses are added, 
then the MAC address must be changed, and the 'ndevs' value 
in the configuration file must be changed. Note that the 
MAC address and 'ndevs' value miiat agree or the system will 
not boot. 

For example, if a new comm mux is to be added at 
address OxlPC on a machine which was previously set up with 
a MAC at address 0x300, then the system must iixfij; be regen- 
erated with the new device address and an 'ndevs" value of 
512. NfiiLtf the new comm mux should be added to the hardware 
and the MAC restrapped for address 0x500. Jhsn, the new 
system can be booted. 

For MAT machines only: the 'ndevs' value should reflect 
the highest device address for efficiency reasons. Setting 
the 'ndevs' value too low (e.g., a value of 256 when there 
is an address above 256) may cause the system to crash when 
devices above address 256 cause interrupts. However, unlike 
on MAC machines, setting the 'ndevs* value too high (e.g., 
1024 when the highest address is less than 256) will only 
waste space, but will not prevent the system from running. 
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